home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / fsr_efs.z / fsr_efs
Encoding:
Text File  |  2001-04-17  |  6.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ffffssssrrrr____eeeeffffssss((((1111MMMM))))                                                        ffffssssrrrr____eeeeffffssss((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      fsr_efs - filesystem reorganizer for EFS
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ////uuuussssrrrr////eeeettttcccc////ffffssssrrrr____eeeeffffssss [----ssss] [----vvvv] [----gggg] [----MMMM] [----tttt seconds] [----ffff leftoff] [----mmmm mtab]
  13.      ////uuuussssrrrr////eeeettttcccc////ffffssssrrrr____eeeeffffssss [----ssss] [----vvvv] [----gggg] [----MMMM] [efsdev | dir | file] ...
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _f_s_r__e_f_s is applicable only to EFS filesystems.
  17.  
  18.      _f_s_r__e_f_s improves the organization of mounted filesystems.  The
  19.      reorganization algorithm operates on one file at a time, compacting or
  20.      otherwise improving the layout of the file extents (contiguous blocks of
  21.      file data) while simultaneously compacting the filesystem free space.
  22.  
  23.      The following options are accepted by _f_s_r__e_f_s.  The ----mmmm, ----tttt, and ----ffff
  24.      options have no meaning if any filesystems, directories, or files are
  25.      specified on the command line.
  26.  
  27.      ----mmmm _m_t_a_b      Use this file for the list of filesystems to reorganize.
  28.                   The default is to use /_e_t_c/_m_t_a_b.  This file must be in
  29.                   _m_t_a_b(4) format.
  30.  
  31.      ----tttt _s_e_c_o_n_d_s   How long to reorganize.  The default is 7200 (2 hours).
  32.  
  33.      ----ffff _l_e_f_t_o_f_f   Use this file instead of /_v_a_r/_t_m_p/._f_s_r_l_a_s_t to read the state
  34.                   of where to start and as the file to store the state of
  35.                   where reorganization left off.
  36.  
  37.      ----MMMM           Reorganize only the metadata.
  38.  
  39.      ----ssss           Print fragmentation statistics only.  The fragmentation
  40.                   percentage reported is 100 divided by the average size of
  41.                   contiguous storage in that category (%frag is file data,
  42.                   %free is free space).  Different files are considered non-
  43.                   contiguous.
  44.  
  45.      ----vvvv           Verbose.  Print cryptic information about each file being
  46.                   reorganized.
  47.  
  48.      ----gggg           Print all output using _s_y_s_l_o_g(3C).  This is the default if
  49.                   _f_s_r__e_f_s is not invoked on a tty.  If _f_s_r__e_f_s is invoked on a
  50.                   tty then output is printed to the tty by default.
  51.  
  52.      The intended usage is to regularly run the _f_s_r command which in turn
  53.      invokes _f_s_r__e_f_s when it encounters EFS filesystems.  By default this is
  54.      done from _c_r_o_n_t_a_b once per week.
  55.  
  56.      When invoked with no arguments _f_s_r__e_f_s reorganizes all regular files in
  57.      all mounted filesystems.  _f_s_r__e_f_s makes many cycles over /_e_t_c/_m_t_a_b each
  58.      time making a single pass over each filesystem.  A pass consists of three
  59.      sub-passes, the first of which organizes the filesystem metadata
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ffffssssrrrr____eeeeffffssss((((1111MMMM))))                                                        ffffssssrrrr____eeeeffffssss((((1111MMMM))))
  71.  
  72.  
  73.  
  74.      (directories and indirect extents) to improve _f_s_c_k performance, the
  75.      second of which compacts files to improve performance, and the last of
  76.      which de-fragments filesystem free space.  The first _f_s_r__e_f_s pass in this
  77.      mode does only the first sub-pass.  It runs for up to two hours after
  78.      which it records the filesystem where it left off, so it can start there
  79.      the next time.  This information is stored in the file /_v_a_r/_t_m_p/._f_s_r_l_a_s_t.
  80.      If the information found here is somehow inconsistent or out of date it
  81.      is ignored and reorganization starts at the beginning of the first
  82.      filesystem found in /_e_t_c/_m_t_a_b.
  83.  
  84.      _f_s_r__e_f_s can be called with one or more arguments naming filesystems
  85.      (block or character device name), directory hierarchies, and files to
  86.      reorganize.  In this mode _f_s_r__e_f_s does not read or write
  87.      /_v_a_r/_t_m_p/._f_s_r_l_a_s_t nor does it run for a fixed time interval.  It makes
  88.      one pass through each specified regular file, all regular files in each
  89.      specified filesystem and all regular files in each specified directory
  90.      hierarchy.  When descending a directory hierarchy _f_s_r__e_f_s reorganizes
  91.      each regular file before descending into subdirectories.  A command line
  92.      name referring to a symbolic link (except to a file system device), FIFO,
  93.      or UNIX domain socket generates a warning message, but is otherwise
  94.      ignored.  While traversing the filesystem or directory hierarchy these
  95.      types of files are silently skipped.
  96.  
  97. FFFFIIIILLLLEEEESSSS
  98.      /etc/mtab            contains default list of filesystems to reorganize.
  99.      /var/tmp/.fsrlast    records the state where reorganization left off.
  100.  
  101. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  102.      fsr(1M), crontab(1), fsck(1M), mkfs(1M), ncheck(1M), efs(4), fsctl(7).
  103.  
  104. NNNNOOOOTTTTEEEESSSS
  105.      An entry in /_e_t_c/_m_t_a_b or the file specified using the ----mmmm option must have
  106.      the rrrrwwww option specified, for example:
  107.  
  108.           /dev/root / efs rw 0 0
  109.  
  110.      If this option is not present, then _f_s_r__e_f_s skips the filesystem
  111.      described by that line.  If this option is not present, make sure that it
  112.      is present in the corresponding line in /_e_t_c/_f_s_t_a_b so that it will appear
  113.      in /_e_t_c/_m_t_a_b when the filesystem is mounted.  See the _f_s_t_a_b(4) and
  114.      _m_t_a_b(4) reference pages for more details.
  115.  
  116.      _f_s_r__e_f_s is a memory intensive program, and consumes memory proportional
  117.      to the number of file and directory inodes in the largest filesystem in
  118.      the system.  Running _f_s_r__e_f_s on a filesystem with 500,000 inodes, for
  119.      example, can require 40 to 50 megabytes of main memory.
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.